home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 020a / gifclp13.zip / GIFCLIP.DOC < prev    next >
Text File  |  1991-09-22  |  13KB  |  318 lines
  1.  
  2.  
  3.                           G I F C L I P 
  4.  
  5.                            Version 1.3
  6.                        September 20, 1991
  7.      
  8.      A Cropping/Clipping Program for Your GIF(tm) Pictures
  9.         Copyright 1990,1991 Steve Enns and Dan Magosse,
  10.                       All rights reserved. 
  11.  
  12.      GIFCLIP is produced by:
  13.  
  14.            Steve Enns                     Dan Magosse 
  15.         2425 Haultain Ave.             1321 14th St. East 
  16.           Saskatoon, Sk.                 Saskatoon, Sk. 
  17.           Canada S7J 1R2                 Canada S7H 0A6 
  18.  
  19.      This document has been stolen from the original GIFWARP!
  20.      document - if you have GIFWARP!, all the "humor" in here    
  21.      is ginna' seem familiar...
  22.  
  23.      Our motto:
  24.      
  25.      "We endeavour to pursue faithfully the highest principles in
  26.      sophisticated program design and development - until we're
  27.      offered more money or more exciting jobs."
  28.  
  29.      Top Ten Phrases heard around this lab:
  30.  
  31.                "What does `File Allocation Table Bad' mean?"
  32.                "Where was that bottle?"
  33.                "Sure it's weird, but will it sell?"
  34.                "Are these deductions right?"
  35.                "Where's that Stones tape?"
  36.                "Yah, C is okay, but can you do it in FORTRAN?"
  37.                "Where was that bottle?"
  38.                "I thought YOU fed the sled dogs!"
  39.                "Error handling?  What's that?"
  40.                "Where was that bottle?"
  41.  
  42.      Okay, here's the boring stuff, but don't worry, it's better
  43.      than chewing tinfoil:
  44.  
  45. ACKNOWLEDGEMENTS
  46.  
  47.      Kudos, thanks, and good karma to John Bridges for the
  48.      enlightening information and code contained in his VGAKIT
  49.      package.  Trademarks like GIF(tm) and PC(tm) are held by
  50.      their respective companies. 
  51.  
  52. DISCLAIMER
  53.  
  54.      The GIFCLIP program is provided without warranty of any
  55.      kind.  The user of the GIFCLIP assumes complete
  56.      responsibility for any and all incidental or consequential
  57.      damages which may occur during normal or abnormal use of the
  58.      GIFCLIP program.  Use the GIFCLIP program at your own risk.
  59.  
  60. LICENSE 
  61.  
  62.      The entire GIFCLIP package, including the GIFCLIP program,
  63.      documentation, and sample files are Copyright 1990,1991
  64.      Steve Enns and Dan Magosse.  All rights reserved.  The      
  65.      unregistered shareware version of the GIFCLIP may be freely
  66.      distributed to others by any means, as long the following
  67.      (three) conditions are met:
  68.  
  69.           1) GIFCLIP is distributed in a "package" containing    
  70.           the following three files:
  71.                               GIFCLIP.EXE
  72.                               GIFCLIP.DOC
  73.                               GC-READ.ME
  74.           
  75.           2) GIFCLIP is not distributed as part of any other     
  76.           product, except with specific written permission from
  77.           the authors.
  78.  
  79.           3) NO fee of any kind is charged for the GIFCLIP
  80.           package or for the service of providing the package,
  81.           except Computer Bulletin Board Systems, which may
  82.           distribute the GIFCLIP package even though they may
  83.           charge a membership or service fee.
  84.  
  85.      You can use the "shareware" version for as long as you want,
  86.      even until you're well into your nineties, but you are of
  87.      course encouraged to send us lots of money, too. (I'm
  88.      struggling to pay for my violin lessons, and Dan needs a new
  89.      fishing rod.)  On the other hand, a "registered" version of
  90.      GIFCLIP is available from the authors for $8.00 U.S.  The
  91.      registered version provides support for 512K and 1024K
  92.      SuperVGA cards from most manufacturers (see REQUIREMENTS
  93.      below).  The registered version is licensed to the          
  94.      purchaser exclusively, and may not be distributed to others. 
  95.      To order the SuperVGA version of GIFCLIP, send $8.00 U.S.   
  96.      to the "Steve Enns" guy mentioned above.  You will receive a
  97.      5.25" (sorry NO 3.5" disks!) disk with the latest SuperVGA  
  98.      version of GIFCLIP.  If you send $23.00 or more, you will   
  99.      also receive the licensed SuperVGA versions of:
  100.  
  101.           GIFWARP!  Warp, bend or stretch your GIF(tm) pictures
  102.                     for bizarre and interesting effects.
  103.  
  104.           GIFSIZE   Resize your GIFs.  Resize the entire image or
  105.                     any part.
  106.  
  107.           GIFEXE    Make your GIF(tm) into an executable program
  108.                     with special effects.  Just run the program
  109.                     to display the picture.  Great for demos or
  110.                     displays or title screens for your programs. 
  111.                     Supports SuperVGA.
  112.  
  113.      Look for the unlicensed shareware versions of GIFCLIP,
  114.      GIFSIZE and GIFEXE on your favourite bulletin board system.
  115.  
  116.  
  117. REQUIREMENTS
  118.  
  119.           GIFCLIP requires the following:
  120.  
  121.                -    PC(tm)/XT(tm)/AT(tm)/386(tm) computer thing
  122.                -    About 280K of free RAM
  123.                -    DOS 3.0, 3.1, 3.2, 3.3, 4.0 (others untested)
  124.                -    A mouse that at least claims to be
  125.                          compatible with something
  126.                -    A VGA or SuperVGA card
  127.  
  128.           and optionally:
  129.  
  130.                -    SuperVGA - The registered SuperVGA version of
  131.                     GIFCLIP supports modes like 640x480, 800x600
  132.                     with 256 colours on 512K and 1024K SuperVGA
  133.                     cards from ATI, Ahead, Cirrus, Chips and
  134.                     Technologies, Everex, OAK, Paradise, Trident,
  135.                     Tseng, Video7, Compaq, NCR, Genoa and VESA. 
  136.                     See the LICENSE section above for ordering
  137.                     information.
  138.  
  139. INSTALLATION
  140.  
  141.      Copy the GIFCLIP program (and this helpful document of
  142.      course!) to any directory that you want - perhaps with      
  143.      your favourite GIF(tm) viewer somewhere in the DOS          
  144.      path.
  145.  
  146. USAGE
  147.  
  148.      Syntax for GIFCLIP is as follows:
  149.  
  150.           GIFCLIP [?] infilename[.GIF] [outfilename[.GIF]]
  151.                     [/text=some~text] [/giftag=giffile[.GIF]]
  152.                     [/autoscale]
  153.  
  154.      or
  155.  
  156.           GIFCLIP [?] infilename[.GIF] [outfilename[.GIF]]
  157.                     [/mode={0,1,2,3,4}] [/text=some~text]
  158.                     [/giftag=giffile[.GIF]]
  159.                     [/autoscale]
  160.  
  161.      for the registered version.  ( The /mode=n parameters are as
  162.      follows:       /mode=0        Ordinary 320x200 mode
  163.                     /mode=1        Low resolution SVGA
  164.                                         640x400 or 640x350
  165.                                         depending on your card.
  166.                     /mode=2        Medium resolution 640x480
  167.                     /mode=3        High resolution 800x600 
  168.                     /mode=4        Higher resolution 1024x768
  169.                                    on some 1024K cards.     )
  170.  
  171.      The /autoscale option will try to fit the GIF onto the
  172.      specified screen mode when the mode is much large than the
  173.      GIF.                                                   
  174.  
  175.      The /text option allows the placement of text on the GIF.
  176.  
  177.      The /giftag option allows placement of another GIF onto the
  178.      GIF.
  179.  
  180.      For example, try:
  181.  
  182.           C> GIFCLIP               to see the title screen
  183.  
  184.           C> GIFCLIP ?             to see the help/brag screen
  185.  
  186.           C> GIFCLIP house         to view/clip the file
  187.                                    HOUSE.GIF writing the clipped
  188.                                    picture (if any) to the 
  189.                                    default name GIFCLIP.GIF
  190.  
  191.           C> GIFCLIP house house2  view/clip the file HOUSE.GIF,
  192.                                    writing output to HOUSE2.GIF
  193.  
  194.           C> GIFCLIP house /text=Copyright~1991
  195.                                    view/clip the file HOUSE.GIF,
  196.                                    adding the text "Copyright
  197.                                    1991" when using the "text"
  198.                                    command.  (See below.)
  199.  
  200.           C> GIFCLIP house /giftag=myname.gif
  201.                                    view/clip the file HOUSE.GIF, 
  202.                                    adding the picture MYNAME.GIF
  203.                                    when using the "gif" command. 
  204.                                    (See below.)
  205.                
  206.      With the registered version:
  207.  
  208.           C> GIFCLIP car /mode=2   View/clip CAR.GIF using medium
  209.                                    resolution SuperVGA
  210.                               
  211. TUTORIAL
  212.  
  213.      Try out the following with your favourite GIF(tm) picture:
  214.  
  215.                C> GIFCLIP picturename
  216.  
  217.      GIFCLIP will load the picture and display it one your
  218.      screen.  The mouse cursor will appear in the centre of the
  219.      picture along with the coordinates of the current position. 
  220.      Choose the area of the picture that you want to save by
  221.      pressing and holding down the left mouse button while moving
  222.      the mouse.  The "clipping box" will move as you move the
  223.      mouse.  Release the left button when the "clipping box" is
  224.      the appropriate size.  To choose a different box, just press
  225.      and hold down the mouse at a different location in the
  226.      picture.  When you have chosen the area of the picture that
  227.      you want to save, press the <ENTER> key.  If you want to
  228.      exit GIFCLIP without saving the clipped picture, press the
  229.      <ESC> key. 
  230.  
  231.      Now try the following:
  232.  
  233.                C> GIFCLIP picturename /text=John~Doe,~1991
  234.  
  235.      GIFCLIP will operate as before, except that now you may also
  236.      place the text "John Doe, 1991" anywhere on your picture. 
  237.      Note that the tilde "~" is used for a space.  You can move
  238.      the mouse around and choose clipping areas as before,  but
  239.      now  when you press the right mouse button, the text
  240.      "John Doe, 1991" will appear, and can be moved around with  
  241.      the mouse.  Press the right mouse button again to place the
  242.      text on the picture.
  243.  
  244.      Finally, you can also try:
  245.  
  246.                C> GIFCLIP picturename /giftag=myname
  247.  
  248.      Now, press the "G" key.  The picture MYNAME.GIF will be
  249.      placed on top of the picture with the upper corner where the
  250.      mouse is pointing.  This option can be used to put logos,
  251.      signatures or any other picture on top of the current
  252.      picture.  (Note that the colours of the original picture
  253.      will be used for the imported picture.)
  254.  
  255.      Both of the GIFCLIP options /TEXT and /GIFCLIP may be used
  256.      together.
  257.      
  258.  
  259. ERRORS
  260.  
  261.      - The following self explanatory error messages may be
  262.      produced by GIFCLIP  The errors involving the GIF(tm) files
  263.      will generally be due to disk errors or faulty image files. 
  264.      Other errors refer to lack of enough free RAM space, or lack
  265.      of required hardware (VGA and Mouse).
  266.  
  267.           Can't initialize VGA graphics!
  268.           Mouse driver not installed.
  269.           Can't allocate mouse memory!
  270.           Unexpected EOF reading GIF!
  271.           Premature end of GIF!
  272.           Not GIF file!
  273.           Invalid GIF format
  274.           Error writing GIF!
  275.           Buffer allocation failure!
  276.           
  277. NOTES
  278.  
  279.      - GIFCLIP reads both GIF87A standard (the original) and     
  280.      new GIF89A pictures, although most of the extensions in the
  281.      new GIF89A standard like (silly) text windows are ignored. 
  282.      The last image in multi-image GIFs will be the one displayed
  283.      for clipping in GIFCLIP.
  284.  
  285.      - Although only the registered copy of GIFCLIP provides     
  286.      full SuperVGA resolution, all GIF pictures can be decoded   
  287.      and displayed on all versions of GIFCLIP.  If the image is  
  288.      too large for the available resolution, the image will be   
  289.      centred on the screen.  You will see the middle 320x200     
  290.      pixels of the image when the entire image is larger than    
  291.      320x200, for example.  The registered version of GIFCLIP    
  292.      will display images at resolutions up to 1024x768 according
  293.      to the size of the picture, or the specified mode.
  294.  
  295. HISTORY
  296.  
  297.      - Version 1.0 Completed June.1 1991
  298.  
  299.      - Version 1.2 Completed Sep.15 1991
  300.           Some additional cards are now supported.  1024x768x256
  301.           modes are now supported on some 1024K cards.
  302.  
  303.      - Version 1.3 Completed Sep.20 1991
  304.           /autoscale is now an option
  305.  
  306. PROPOSED FUTURE ENHANCHMENTS
  307.  
  308.      - Support for other graphics hardware.  Hopefully, we will
  309.      be able to support new hardware and graphics modes as they
  310.      are introduced.
  311.  
  312.      - Faster GIF(tm) decoding and encoding
  313.  
  314.      - You tell me!
  315.  
  316.  
  317.  
  318.